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Editor's Thoughts 



by Jim DeStafcno 



Another mile stone has been 
passed. All the people involved with 
The 6 8 xxx Machines deserve a pat on 
the back. This is the sixth month, 
half year, issue. "Thank you" to 
those that have voted their encour- 
agement with articles. By now you 
must have noted they are not a re- 
hash, but rather are current and 
contain information that can be used, 
today . 

"Thank you" to those that are 
advertising. I have not heard one 
complaint about the products or ser • 
vices. And of course "Thank you" to 
the subscribers, without you all it 
would be a pretty useless exercise. 

To try to obtain better results, 
we're experimenting with different 
character fonts and with a new method 
of producing the copy that eventually 
goes to our printer. The new font 
allows us to increase the amount of 
material we can publish without re- 
ducing the size of the type. Hopeful- 
ly the new font will also be easier 
for you to read. 

Speaking of our printer. Randy 
Krippner, who does some of the desk 
top publishing work to put 68xxx 
together, omitted the two year price 
of a subscription for foreign coun- 
tries on the subscription coupon. 
When I mentioned it to Mike, our man 
at the printer, he said he could 
"pencil" it in. Did you notice what 
he did? Mike, thank you for the ef- 
fort, but you didn't fool any one. No 
one sent $133.50; guess we better go 
back to the intended $33.50. 

Got a letter from Paul Ward. You 
know, the main MM/1 man. He very 
nicely said some of my observations 
printed in the May '91 issue of his 
machine at the Chicago RAINBOWfest, 
were out of order. He said that; "The 
MM/1 was showing animations and grap- 
hics in fine color. They were not dim 
in any way. In fact, the MM/1 display 
is as bright or brighter than either 
of our competitors. - (The italics are 
mine, ED.) Okay, sorry if what I saw 
was not what I thought it was; maybe 
I was looking at night scene in an 
adventure game. 

In another part of the letter, 
Paul commented about my remarks re- 
lating to the moderated 'talk' be- 
tween Ed Gresick, DELMAR; Frank Hogg, 
FHL and himself, "Frank continually 
gave me a hard time because our booth 
sign said the MM/1 was faster then 
competing systems. (The italics are 
mine, ED. ) Anyone who has seen our 



brochure realizes that ve compare 
ourselves prominently to systems that 
we do beat in speed." Ahaa Paul, not 
sure competitors can mean particular 
companies in one reference, but not 
those same companies in the next. 

There are other points in the 
letter such as IMS has been deliver- 
ing computers longer then DELMAR. 
Humm, maybe so Paul, but will you 
send me a name of a purchaser that 
has received a complete MM/1 with a 
working hard disk; I'd like to print 
a taped telephone conversation review 
for our readers. 

On another day Frank Hogg called. 
We kicked around a couple of things, 
like my comments on the "fest". For 
one, he says he doesn't like an in- 
ference that his machine is slow; 
especially when hie and the MM/1 use 
the same CPU and clock speed. He also 
gave a little insight on cost. Both 
his and the DELMAR machines are 
shipped with their expansion buses in 
place, while the MM/l's is not. At 
the 'talk' Paul said the MM/l's will 
be an upgrade. Frank allowed, an 
expansion add-on bus will not be 
cheap, and expects the final cost of 
each machine will be about the same, 
if the MM/l's isn't more than the 
others. 

Addressing my question about lead 
time, Frank said the TC-70 lead time 
is running 4 to 6 weeks due to the 
lead time on some parts. 

He also said he would send a press 
release sheet on two new products. 
One a 16Mb Ram Disk board for the 
KBus and second, a new 68030 based 
computer with lots of aerial ports. 
The hard copy hasn't arrived as yet. 

What else? Not much; Gresick is 
quiet. Too busy shipping computers I 
guess. Be talking with you next 
month, take care for now, and thanks 
again to everyone for the six months 
of support. JHD 
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OSK And Super 
Terminals 

by Bob van der Pod 



Hoiking with OSK, a system desig- 
ned to be adaptable to different 
types of peripherals, including dif- 
ferent terminals can be fun. Such 
flexibility often results in chal- 
lenging problems in search of solu- 
tions. Things which are trivial on a 
"fixed" system like MS-DOS, become 
the subject of endless debate and 
excuses to stay up late in the com- 
puter room. When designing my VED 
text editor I was faced with such a 
"problem. " 

The VED uses the OSK *C Termcap 
Library to handle the terminal out- 
put. The Termcap Library is a set of 
C routines which read a data file 
containing the information needed to 
do terminal output, attributes like 
highlight, underline and blinking; 
plus the size of the screen, cursor 
positioning, etc. To extract the 
correct information from the data 
file the SHELL variable "TERM" is set 
to the name of the terminal being 
used. All this works smoothly, once 
the teimcap data file is Bet up prop- 
erly; except fox one email detail, 
the screen size. 

The screen size listed in the 
termcap data base for a particular 
terminal is, like all the other val- 
ues for that terminal, a constant. If 
your terminal is a "White Bread Whiz- 
Bang" with 80 columns and 22 lines 
there is no problem. But what if the 
terminal has variable sized screens? 
Or if you have a system using a win- 
dowing system? 

One solution is to have the user 
enter the screen size as a command 
line option which will override the 
termcap values. It works, but it's 
not too friendly. Another solution, 
assuming a console system, would be 
to have the program interrogate the 
system with a OetStt. Nice idea, but 
it fails with a remote terminal and 
assumes that the program knows how to 
do the interrogation; (Micxoware has 
not supplied a standard GetStt code 
for this) . 

Another solution might be to have 
the terminal size set up as a SHELL 
variable. T this is a good idea, but 
it creates problems when a windowing 
system is changing the size often. 

The solution I came up with is to 
use a extension module to let the 
editor know about the screen size. If 
the module exists, VED gets the size 
from it; otherwise it uses the term- 



cap entry. The extension module sim- 
ply prints the number of rows and 
columns to standard output. It can be 
written in any language and can get 
the size in any manner it wishes, via 
a GetStt, from some kind of informa- 
tion file or from a SHELL variable. 
VED has no need to know how the size 
was determined, it just needs to know 
what it is. 

A simple example, of the extension 
module (called "ved_ssize") would be: 

main!) 

{ 

printf ("%d\n*d\n" , 80, 26) ,- 

) 

Of course, if the need for the 
program exists a more complex program 
would be needed (the example would be 
better handled with the termcap en- 
try) . 

The only thing remaining is for 
VED to get the data. The method I use 
ie fox VED to call ved_ssize with a 
pipe opened so VED can read the out- 
put from the called program. The 
following code shows how VED does it: 

save_std_out*dup(l) ;/* save stdin •/ 
closed) ,- /* force pipe to */ 
open ("/pipe" ,S_IREAD»S_IWRITE) ; 

/* use path 1 */ 
t-oa9f ork ( "ved_ssize" ,0,0,0,0,0,0) ; 

/* run sizex */ 
pipe_path*dup(l) ;/• save forked prog 

~ output •/ 

closed) ; 

dup(save_std_out) ; /'restores etdout*/ 
close (save_std_out) ; 

if(t>0)( - /* fork successful •/ 
cread(pipe_path,buf2,sizeof (buf2) -1) ; 

/• get columns */ 
get_exp(*J,buf2,&e) ; 
if(!e)( /'no error evaluating 
xsize*/ 

cread(pipejpath,buf2,sizeof (buf2) -l) ; 

/* get rows ♦/ 
get_exp (id , buf 2 , te) ; 
if(!e) set_ssize(j,i) ; 
/•go set size - */ 
) 

) 

close (pipe_path) ; /'close pipe path*/ 

In the above fragment creadl) 
reads a string and appends a null to 
it, get_exp() evaluates a numeric 
expression and set_ssize() sets the 
screen size. 

This might not be the most elegant 
solution, but it does have a number 
of advantages. First, the code for 
both the main program and for the 
auxiliary program is straight forward 
and easy to write aB well as main- 
tain. Second, the main program does 
not need to make any assumptions 
about the user's terminal. 

In the future I hope to cover more 
picky problems like this. If you have 
a request, question or comment please 
contact me at: 
PO Box 57 PO Box 355 

Wynndel, BC Porthill, ID 

Canada V0B 2N0 USA 85853 
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Rush Caley, LIVE! 



For yeaia, I could nevei under- 
stand why certain people engaged in 
activities I deemed "crazy. Here's a 
few examples of what I mean. Bunji 
Cord jumping, mountain climbing, rock 
climbing, white-water rafting, hang- 
gliding, sky-diving, and many more. I 
never could dredge up more than a 
modicum of sympathy when I read head- 
lines about fatal accidents involving 
this type of activity. But now as my 
45th birthday approaches, I've final- 
ly reached an understanding of these 
endeavors. It has nothing to do with 
bravery, death-wiBh, or a neurotic 
need for attention. I now see that 
these people are merely reacting to 
the "predicament" of life in one of 
the two equally moronic alternatives 
available. 

For this is the predicament of 
life: it's dangerous! I recently 
heard about the results of a study 
that showed left handed people die 9 
years earlier than their right handed 
counterparts. The dangers appear when 
you are very young and continue to 
multiply and haunt you through life. 
If you run with the scissors or play 
with BB guns, you'll put your eye 



out. If you keep making that face, 
your mouth will stay that way. If you 
continue to pick at that, it'll be- 
come Infected. Loud music will deafen 
you; and in addition to sitting too 
close to the television, we all know 
what will blind us for sure. 

Eating too much will make you 
sick; not eating enough will make you 
sick; eating the wrong foods will 
make you sick. Driving too fast is 
dangerous, driving too slow is dan- 
gerous. Too much sun is bad for you, 
too little sun is bad for you. We 
live in dire fear of atom bombs, 
earthquakes, tornadoes, volcanic 
eruptions, holes in the ozone layer, 
AIDS, Cancer, and a host of other 
diseases frightening enough to keep 
you awake all night. 

And if that's not enough, not only 
are we physically in mortal danger, 
we are also spiritually at risk. If 
you have no religion, you'll go to 
hell. If you have religion, but it's 
the wrong one, you'll go to hell 
Heaven will be a small golden city 
for those clever enough to get it 
right. 

So how does one cope with all of 
this disaster that envelops our exis- 
tence? Well, it appears to me now 
that there are basically two alterna- 
tives to just "plodding ahead" with 
our lives. The first alternative I 
mentioned at the outset. It now makes 
sense to me why people engage in some 



*** New For OS-9/68000 *** 

Our famous VED text editor is not* available for computers running the OS-9/68000 
operating system. It uses TERHCAP functions to make it compatible with most 
erninals Nearly all of VED's internal settings (.aero definitions y-biadings 
e tin, .odes, e c ) can be modified fro. an initialization file. VED's editing 
Zrll f / if 1 "? 6 ,nsert /°»" st »ke .odes, auto.atic indenting and nn.bering! 
wordwrap on/off etc. Standard functions like search, find/replace, hlock.ove/ 
copy/ e ete, word and line delete are completely supported with countless Ta u 
ad opt.ons. A complete set of "ondo" functions make it easy to correct mistakes 

H ill l S I bUlU V n , teXt f ° r,atter; included in the c °»»^ «t are .a r, n 
settings, headers and footers, jostification .odes, and e.bedded co..ands for 

rt r e 0 a U sVt" se r e f :h n ! S t ft"!-' ^ >" interaCti " e ^ « « 

HZLl \ i the d0CUBeBt HiU looV ,il,e Hhen Panted. User 

extendable help screens speed things up when you just need a refresher, rather than 
using our detailed, indexed 68 page reference gnide. 

«9?95"lus ED 53. 1 00 S s e /H. end US ^ CheCk " ° rder <S ° rry ' n ° Credit cards > for 

Bob van der Poel Software 
PO Box 57 po Box 355 

Wynndel, B.C. or Porthill, ID 
Canada VOB 2K0 USA 83853-0355 
Telephone 604-866-5772 
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of the more intiepid endeavors. It's 
a retaliatory measure. In other 
voids, a person says: "I'm not going 
to wait fox Cancer, an earthquake, 01 
an out of control Bus. If I've got to 
go, I'm going to go in a blaze of 
glory." That's understandable now. It 
beats the hell out of a hospital bed 
and tubes jammed into every conceiv- 
able opening. 

But roe? I'm not on my way out to 
buy any scuba gear just yet. It's not 
that I'm "chicken"; but even though I 
have more understanding of those 
types of risky entertainment, I'm one 
that just doesn't have the where- 
with-all to go asking for it. I 
choose to just "plod ahead" even 
though it's a jungle out there. 

What's the second alternative I 
alluded to earlier? Not very attrac- 
tive, I'm afraid. Not really worth 
the effort to mention it. Just stay 
in bed and never come out from under 
the covers. Never go anywhere. Never 
do anything. Play it safe. Some life. 
All fear, no fun, and wind up just as 
dead. Like I said, moronic. Well, I'm 
on my way out the door to the movies. 
I'll probably even put extra butter 
and salt on my popcorn. 




What Is Minix? 



by Joseph Fosco 



Several years ago after building a 
Peripheral Technology PT68K-2 comput- 
er kit I tackled getting an Operating 
System for it. I liked the idea of 
Unix, but after a little research I 
found, if available, it would be very 
expensive. 

At first, the closest thing avail- 
able for the PT68K-2 I could find was 
OS- 9. It looked good, however, it was 
rather expensive and its source code 
wasn't available. Not long later I 
heard about a Unix look-alike called 
MINIX. I was able to test run it on 
an IBM PC. Soon I found myself con- 
sidering doing a port of the system 
to my PT, (what better way to learn 
about operating systems?) ; but as it 
turned out it was not necessary. 
Someone had already done it. Before I 
begin with "Getting MINIX to Run", 
perhaps a little background on MINIX 
would be appropriate. Much of the 
following information comes from the 
MINIX Information sheet available on 
USENET. 

MINIX is an operating system very 
similar to UNIX. It was written by 
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Dr. Andrew S. Tanenbaum fox teaching 
operating system design. MINIX was 
written from scratch and does not 
contain any AT&T code. Foi this rea- 
son, source code is made available. 
The current version of MINIX is 1.5. 

MINIX is a full multiprogramming 
operating system (allows more than 
one program to run at once) . In addi- 
tion, it is system call compatible 
with V7 of the Unix operating system. 
MINIX comes with a C compiler that is 
K&R compatible (no floating point 
support, or source code), and a shell 
that is functionally identical to the 
Bourne shell, over 175 Unix utilities 
are included as well as 200 library 
procedures. The distribution includes 
full source code (in C) for the oper- 
ating system, utilities and librar- 
ies. 

A book by Andrew s. Tanenbaum 
describes operating systems in gener- 
al and MINIX in particular. The de- 
scriptions and source listings in the 
book are for the early version of 
MINIX, but are still useful, if not 
required, for understanding MINIX' s 
internals. The book is: 

Title: Operating Systems: 

Design and Implementation 

Author: Andrew S. Tanenbaum 
Publisher: Prentice-Hall 
ISBN: 0-13-637406-9 

MINIX is sold by Prentice-Hall. 
Some software stores stock MINIX, or 
it can be ordered directly from Pren- 
tice-Hall. 

Prentice-Hall sells MINIX for only 
a few machines. These are: 

IBM (5 1/4"), ISBN 0-13-585076-2 

IBM (3 1/2"), ISBN 0-13-585068-1 

Amiga ISBN 0-13-585043-6 

Atari ISBN 0-13-585035-5 

Macintosh ISBN 0-13-585050-9 

All versions cost $169.00 plus tax 
and shipping. Included in this price 
is executable binaries, a detailed 
manual, complete source code (on 
diskettes), and a typeset; cross- 
referenced listing of the operating 
system. Prentice-Hall can be contact- 
ed at: 

Microservice Customer Service 
Simon and Schuster 
200 Old Tappan Road 
Old Tappan, NJ 07675 
Phone Orders: (800) 624-0023 or 
(201) 767-5969 

Even though source code is includ- 
ed, MINIX is not public domain, Pren- 
tice-Hall has copyrighted it. Howev- 
er, they grant permission for univer- 
sities to copy the software under 
certain circumstances. Also, MINIX 
owners are allowed to modify the 
operating system and distribute 



'diff listings. The shrink wrap 
license allows the owner to make 2 
backup copies. 

If you're reading this there is a 
good possibility you do not own one 
of the computers for which Prentice- 
Hall is distributing MINIX. However, 
all is not lost. MINIX has been port- 
ed to several other computers; such 
as the PT68-K2 via modifications 
called 'diff listings. The hardest 
part of getting MINIX for one of 
these "other" computers is determin- 
ing if there is a "bootable" 'diff 
listing available. 

As mentioned earlier, MINIX is 
copyrighted. It is not legal to dis- 
tribute copies of the source code, 
even if modified for another comput- 
er. Prentice-Hall does allow the 
distribution of these 'diff list- 
ings; which are "different" from, and 
modify, the available commercial 
versions. To get one of these 'diff 
versions of MINIX working, locate the 
'diff listing fox your machine, 
purchase the proper commercial ver - 
sion for the 'diff listing you need 
to use, apply the 'diff s to the 
commercial version which rebuilds the 
operating system, and load it to a 
disk bootable on your computer . (Be 
sure to purchase the correct commer- 
cial version. The Atari 'diff a will 
only work with Atari commercial ver- 
sion, and the compiled result will 
not work on any other computer . 

There is no official source for 
the MINIX diff s. Most of the activ- 
ity occurs on or through the USENET 
discussion group, comp.os.minix. in 
addition to questions and answers, 
numerous programs and 'diff listings 
are posted regularly. This group is 
also carxied as a BITNET mailing 
list. The activity from this discus- 
sion group is archived at numerous 
sights, so past postings can be down- 
loaded via FTP or LISTSERV. 

For those without access to USENET 
or BITNET there is a BBS that carries 
all traffic from comp.os.minix: The 
Mars Hotel BBS 301/277-9408; 300, 
1200 and 2400 baud, 8, n, 1. No reg- 
istration. Everyone gets 60 minutes a 
day. No upload/ download ratios. 

PT68-K owners can obtain every- 
thing they need to get the Atari 
version running on a PT68-K from a 
bulletin board operated by Michael 
Evereon, 817/488-8398; 300, 1200 and 
2400 baud; 8, n, 1. No registration, 
no time limit. 

Once the diffs you need are ob- 
tained, you must create a version of 
the operating system that will boot 
on your machine. This is greatly 
simplified if a "boot-disk" for your 
target system is available. A boot- 
disk is a listing of the MINIX kernel 
that will run on the target computer. 
Once running, the source code can be 
unpacked and the 'diffs applied. 
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Without a "boot-disk", minix must 
be running on the computer from which 
the port was made. The 'diffs can 
then be applied to the sources and 
the operating system recompiled. The 
executable modules must be transfer- 
red to the target computer and saved 
on disk, you must then create a disk 
that will allow MINIX to boot. This 
format will vary from machine to 
machine, but if you have network 
access I'm sure help can obtained 
there. 

If you are porting to a 680xx 
(68020, etc..) processor, the vast 
majority of the code will not have to 
be modified. Most of the work will be 
in rewriting portions that handle the 
hardware (Interrupts, Clock Timer, 
Keyboard, Display, Disk Drives, 
etc.). After recompiling the code, 
the process will be identical to 
getting a version with 'diff list- 
ings working (transfer to the target 
computer, and create a boot disk). 

I understand that porting MINIX to 
one of the more powerful 680xx pro- 
cessors requires quite a bit more 
work due to a difference in inter- 
rupt/trap handling. 

HAJtDKAKK MQOIIUBtXIlTS FOR MINIX 

Many people run MINIX on an IBM XT 
with S12K and two floppies. This is 
what I would call the absolute mini- 
mum. You could get MINIX running and 



do some work with it, but you would be 
severely restricted. I am not sure if you 
would be able to recompile the operating 
system with this configuration, but even 
if you could the disk swapping would be 
horrendous, of course the larger the 
system the more you can do. I would rec- 
ommend the following for a practical 
lower limit: 

1 megabyte ram, 1 floppy drive, 1 20Mb 
hard drive and a text only monitor . 

Currently a text mode monitor is the 
only option available. Some graphics 
routines have been developed (there is 
even work on bringing over X-Windows), 
but text mode is all that is supplied in 
the official releases. 

Locating and obtaining MINIX for a 
non-supported system is really the big- 
gest problem. Once you have it running, 
it works very well. The biggest complaint 
I've heard about the 6 8000 version of 
MINIX concerns its method of memory man- 
agement. Because it does not use a memory 
management unit, MINIX keeps multiple 
processes running by copying them around 
in memory. Under most circumstances this 
is not as big a problem as it might seem, 
but there are instances where this cre- 
ates a severe degradation in performance 
(most notably this occurs while running 
Kermit) . 

Is it worth it? Personally, I'd answer 
with an unqualified YES! Although $169.00 
might seem a little steep for an operat- 
ing system, when you consider all that is 
included it is really a bargain. Not only 
do you get the operating system but 
source code, a C compiler, and several 
editors! The fact that MINIX is so much 
like Unix allows many public -domain Unix 
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source programs to be compiled without 
modification. 

The package is an excellent introduc- 
tion to advanced operating system con- 
cepts, with MINIX you get hands-on expe- 
rience with OS design. Even if you never 
have a need to work with the source code, 
MINIX will provide you with an understan- 
ding of many of the system administration 
issues involved in the operation of a 
large scale OS. 

Finally, aside from the educational 
value, MINIX is a very powerful operating 
system. Although it is not as visually 
appealing as something like Windows or 
Mac-OS, operationally it is more power- 
ful. MINIX is very much a programmers 
environment. If you hope to buy applica- 
tions to run with MINIX, you will be 
disappointed. If you want to write your 
own applications you will find MINIX an 
ideal OS to work in. 

If you've read this far, you realize 
that getting MINIX to run on a computer 
not supported by Prentice-Hall is not a 
trivial exercise. However, with persis- 
tence and ingenuity you too can do it. My 
own experience was not smooth (this seems 
to.be the norm). I do, however, have a 
floppy disk version running and am work- 
ing to get a hard disk up. The tale of my 
journey to booting MINIX will be the 
subject of a future article. In the mean- 
tine, if you have any questions feel free 
to write to me c/o "68xxx Machines". If 
you have an address on BITNET, Internet, 
or CompuServe please include it. JF 



Inexpensive Flex 
Floppy Drives 



by Alen Gordon, MD 

This article shows how to convert 5 
1/4" and 3 1/2" inexpensive Teac brand 
1.2Mb floppy drives intended for IBM 
system use, for use in Flex based sys- 
tems. Drives used this way will format 
floppies which are compatible with flop- 
pies formatted on older Flex systems. I 
have never used any brands other than 
Teac, but this information may apply to 
other brands as well. 

As the capacity of floppy drives be- 
came larger one step was double-density, 
and double -sided. Early drives had 40 
tracks each side and were called Quad 
density. The next increase was to 80 
tracks on each side, and was called Octal 
Deneity. Octal density drives are format- 
ted to 1Mb total capacity, of this, the 
user receives 2844 sectors of 256 bytes 
per sector; or 728,064 bytes. IBM calls 
this format standard, 7 20K. 

The main difference between the IBM 
1.2Mb drive and other drives is the rota- 
tion rate. The 1.2Mb turns at 36 0 rpm, 
all other 5 1/4 inch drives turn at 300 
RPM. All the 3 1/2 inch drives turn at 
300 RPM as well. Bench testing floppy 
drives will demonstrate this by measuring 
the time between two index pulses on pin 
8 of a drive. The 'all other' drives have 



SK*DOS®/68K Upgrade Offer 

Why make do with a me-too DOS when you can upgrade to the new, faster SK'DOS and get all this 
at a special price: Simple-to-use DOS with full document? don and on-line help • Multiple directo- 
ries • Multiple I/O devices and drives • User-installable device drivers • Keyboard type-ahead • 
Print-screen • RAM disk • Disk cache • 5'/4" and W floppy disk support, normal or high density 

• Easy hard drive partitioning • I/O redirection to drives or I/O • Time/date stamping of files • 
file or disk write-protect (even hard disk) • Batch files • Monochrome or color video board support 

• Read and write MS-DOS disk files • Emulator for running a wide variety of 6809 programs • 
Powerful utilities such as copy-by-date, undelete, show differences between files, prompted delete, 
text file browse etc. - all included • Basic interpreter included • Fast assembler included • Editor 
included • User support via newsletter, BBS and users' group • Available third-party software 
includes C and other compilers, full Basic, screen editors, disassemblers, cross-assemblers, text 
formatter, ROM-based debugger, modem communications program, screen-based shell and hard 
disk manager program, and more. 

SK*DOS is now priced at $70, but here is a special upgrade offer for 
new users: trade In any old 68K DOS and get SK'DOS for just $50. 

(Note to current SK'DOS owners: as always, your upgrade price remains at S5.) 




JlteilMK Star-K Software Systems Corporation 




P. O. Box 209 
«| Mt. Kisco, NY 10549 

Phone/Fax: (914) 241-0287 • BBS: (914) 241-3307 
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a period of 60/300 which equal 200ms be- 
tween pulses. The 1.2Mb drives will show 
60/360, ox 170ms between pulses. 

This attempt by IBM to increase the 
capacity of the 5 1/4 inch drive in this 
way was one of the worst ever made. The 3 
1/2 inch drive increases its capacity 
from 720Mb to 1.44Mb by leaving the rota- 
tion rate at 300 RPM, while using better 
media and increasing the data transfer 
rate by 100%. 

For some reason the s 1/4 inch drive 
went from 720K to 1.2Mb (An increase of 
67%) by increasing the rotation rate by 
20% and increasing the data transfer rate 
to account for the balance. Fortunately 
for us the newer l.2Mb drives will still 
handle lower data transfer rates. All 
that is needed is to make the drives turn 
at 300 RPM. (of course, the 1.2Mb drives 
are widely available and cheap.) 

Teac Octal density drives had names 
like FD-55SR. Current 1.2Mb drives have 
names like FD-550FR. As far as I know, 
the 'F' means the drive turns at 300 RPM. 
'O' means the drive turns at 360 RPM; 
which makes it IBM compatible. 'GF' means 
the drive is convertible to either. 

Many floppy drives are manufactured to 
be configurable to several different 
formats. To make it easy to do, the driv- 
e's PCB (printed circuit board) is prewi- 
red with each possibility, but are left 
unpowered. To invoke a given possibility 
a little device called a shorting block 
is slipped over two pins. These blocks 
complete the connection between the pins 
and thereby complete the circuit. 

Shorting blocks come in different 
sizes; be sure to use the proper size. 
They can be obtained at most electronic 



stores , 

The pins the shorting blocks are 
slipped over project out of the PCB. They 
have identifying letters and numbers 
printed next to them on the PCB. 

To make a Fp-55GFR drive turn at 300 
RPM slip a shorting block over the two 
pins labeled ' I ' and another over those 
labeled *LO'; (Leave the existing blocks 
in place). That is all there is to it! 
You now have an unlimited supply of 
brand-new s 1/4 inch drives for less then 
$80. It will even read and write your 
cheapest older single sided floppies at 
720K. 

Adding a shorting block to the Teac 3 
1/2 inch drives at 'HHI' disables the 
drive's ability to tell the difference 
between 720K and 1.44Mb floppies. Any 
floppy looks like a 1.44Mb format when 
'HHI' is shorted. When done, this seems 
to put a 1000 ohm resistor across the 
switch which senses if the floppy is 720K 
or 1.44Mb. 

With 'HHI' shorted you can put any 
720K floppy in the drive and format it to 
1.44Mb. The disadvantage is, if you put 
this same floppy in other drives, it will 
look to be 720K, and be unreadable, of 
course 1.44Mb floppies will read and 
write correctly, and the data can be 
transferred to other drives. 

Pin spacing on Teac 3 1/2 inch PCB 
drives is not 0.1 inch, rorcing regular 
0.1 inch shorting blocks will ruin the 
drive's pins. If you have any questions 
or comments, please write, inclosing a 
SASE, to 160 NW 176 St, Miami FL 33169 



Micronics Research 
RBASIC 

Enhanced BASIC Interpreter 
with built-in Line-Editor 
for 6809 or 68000 FLEX/SK*DOS 



US$100 + $5 Shipping/Handling 
continental USA and Canada 
($10 S/H elsewhere) 

** Please specify Disk Size and Format ** 

(e.g., 5-inch 80-track) 

Sorry! No credit cards! 
Checks may take 2 v/eeks to clear 

Please make Bank Draft/Money Order payable to: 

R.Jones, 33383 Lynn Avenue, Abbotsford, 
B.C., CANADA V2S 1E2 (604)854-6814 
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SYSTEM IV , Tie 68000 
Computer already serving 
. customers here axid abroad! 
• Expandable using readily available 

low<o«<Aids 
YlcxMv enough to tailor tvjwt 

requirements 
Versatile eiiough to use <&9/6606$ ii 

OS-9/Som MS-DOS and other 
Operating Systems 
Powerful* outperforms other 
machines io its' price class 



THE BEST OF ALL WORLDS 
1 • A MoW-Usex MTuUTaskiag 

■ \ ! : System : : ::::: \{ : \ 

2> Optional Phtg-in Board for 
MS-DOS 

$ - Optional Emulator/Interpreter 
for OS-9768000 Software 

4 r Will support Other Operating 
System* 



Just call, FAX, or drop us a line. We 
will respond promptly with complete 
pricing and specifications, 
DELMAR CD ■ serving its* customers since 1975. 
erminal Systems ... . from $999.00 Console Systems .... from $1,149.00 

Assembled board* and ki*t inikble 

delmar co 

Middlettnm Shopping Center . PO Boat 78 . Middletown. DE 19709 
30&37&2555 FAX 30Z27a2556 



OS9/68000 SOFTWARE 



M6809 * 6809 Emulator/Interpretdr $ 90.95 

M6609 «twl»W: theater mod* o$9 jUswl H o^ttog :wd itowpww &ifc6iw» Maw 1 ' ' 
abject module* ttnjw:os»6800ft: ; • i nil: -i ; ; ; m ■■ m m ■§ mii ; i. ^ ;; ; y y : i :■ ■ ■ ■ ; • ; ; ; : f: 



QUICK ED. Screen Editor and Text Formatter $275.00 

A high quality documentation tool tod program editor ideally raited to later printer wen. Urn 
function and cure* keyt on any terminal, configurable per titer. Micro- jwti/it* mixed proportiooal 
text Automatic table of con tend generation and uier-def inable macrot and command*. Handlet an 
unlimited number of font*. Drive* any printer. Ideal for uultMiaer tyttemt, Available oo a 30day 
try bef ore-you-buy baau. 



FLEXEIW V4.00 . The C Source Code Checker " WW 

Flexeliot find* (juirk*, idiceyntttrii* j&tthei arid bug* in G program*. 60 option* control checking 

bf.wm mm* or RtM:m«il» include tnttm^ol* lw«»i»t»^;d^^ 

■usage of variable*, ttrature*, union* and array*, indentation, etje faBthrougb, type wmrernoni: 
: printf an3 tcanf fonnat ttring incomiitendet, and tutpietetu MankolMa. A mutt for all aerinut € 
: programmer*. ] • '■ : . ■ ~ ; , 1 ' 



DISASM.OS9-OS-9/68K Disassembler . 8250.00 

TMi highspeed, tWput 68000 dutawmbler can ibo handle the 66010 and 6802a It in- 
telligently deeodet module header* and produce* lymbol information that can be repeatedly edited 
and pajted through the diuiteinbler allowing iterance ditattembly. The tyttern librarie* are read to 
tupplytymhola, 



IMP n Intelligent Make Program — — $250.00 

IMF doe* everything you wished :]&crcweV Make wedd id* «ad * great deal awre. lt it 
weftheht red, eecnrteat, and extremely flexible. It bw t bmltiitt Glike nreprbeeewc and bat com< 
: pwhentlw dekogglM f*tUitv«. mt-m-U\**4*ito&iUl mike file* ft* jst* wbet than 

! jaMemMy-Ungatge »t Compilation weeaally conttruetsd. : : : ::::: :■;;:; :::; . . . . ::::::;;;;:.:.: : : : :: ; .: .: j il 



WINDOWS • C Source Code Windowing Library $250.00 

Tint C tource code library package tupportt multiple overlapping window* ditplayed on one 
character-bated terminal tcreen. It tupportt window header* and footer*, and pop-up window*. 
Vindewi mty be moved, panned, written to while offscreen, etc. 



PROFILE- User State Program Profiler $270.00 

Dedgned to profile: nteretate program*. Profile effectively tamplei a traced execution building 
: *t»rUo4 Wocmati6a at it goe* It read* lymbol table module* to give: a luscttoa^tmctioii account 
*f the; time ipen* during execution, The uaer nay Neara-in**) a function to find a tmtBer range of 
A&ictma where time it being tpent - ■ . ■: . 



PC9 - MS-DOS to OS-9 Windowing System $350.00 

PC9 tllowi an MS-DOS computer to be uted u a terminal to multiple procettei on a remote 
OS-9 tyttem linked by a tingle terial cable. Bach OS-9 procees it diipltyed through a 
retittbU, moveable window on the PC tcreen. Terminal emulation facilltiei lupport uMACS 
and other tcreen editor* and provide a programmable PC keyboard. Acceat to PC dltk drive* 
it alto aviltble through the OS-9 unified I/O tyttem, giving diak capability to ROM bated 
OS-9 tyttem*. 

delmar co 

Middletown Shopping Center- PO Box 78- MtddUtewn.DE 19709 
302-378-2555 FAX 302-378-2556 



Why Your Disk 
Drive Won't Work 



by Ed Gresick 



In the beginning of June I received the 
tolloving leccez Horn Bill Hughes or Valley 
Falls, Kansas. ED. 

Editor : 

I would be very interested in an 
article about sharing software among 
the various machines running OS -9 (or 
SK*DOS, REX, etc.) I have described 
my experience below; but I'm sure 
some of your regular contributors 
will have wider experience. 

I have a PT68K-4 with a 3.S" and a 
5. 25" floppy drives. Originally both 
drives were running on the Western 
Digital 1772 floppy disk drive con- 
troller. The default OS-9 format for 
this machine is 10 sectors/single 
side on track 0; and 16 sectors per 
track/double sided for all other 
tracks (os-9 "standard"). 

The problem began when I ordered 
software that was advertised for the 
CoCo. It was to run under OS-9, so I 
assumed there wouldn't be any trouble 
getting it onto my machine. The fol- 
lowing points are notable: 

1) The CoCo and the PT68K use 
different "standard" disk formats. I 
now know how to change the descrip- 
tion in the IO/dO.a file, compile a 
new descriptor, and generate the 
proper boot file. However, getting 
this information from square one was 
not easy, it became a real learning 
experience for a beginner like my- 
self. 

3) The 1772 chip on the HD (high 
density) 5.25" doesn't seem to like 
CoCo disks, regardless of format. I 
later installed the newer 37C65 chip. 
It seems to handle anything (so far), 
so now I can share 5.25" disks (pro- 
vided we agree on which format to 
use. ) 

3) The 3.5" drive on the 1772 
controller reads/writes/formats (in 
PT68 standard format) disks that are 
readable/writable by CoCo. 

4) I couldn't get the 1772 con- 
troller to give reliable results on 
either drive using CoCo format. 18 
sectors per track may be too much for 
it to figure out. 

5) Obviously, always use DD (doub- 
le-density) diskettes: my 5.25" could 
handle HD diskettes without a prob- 
lem, but I guess CoCo's are strictly 
DD drives. 

I have been working with Bob van 
der Poel on this CoCo<->PT mess. He 



has also had experience with trans- 
fers between CoCos and MM- Is. He 
included his format scheme when he 
sent the software; which was very 
helpful, since it got me beyond the 
easy solutions pretty quickly! 

In summary I would caution PT68K 
users to be careful about mixing and 
matching drives and controllers if 
they want to exchange disks with 
non-PT machines. Also, it might be a 
good idea for software companies to 
indicate what format they use (or, 
heaven forbid, adopt a STANDARD!). 



This looked pretty serious to me 
so I forwarded it to Ed Gresick of 
the DELMAR CO, the distributors of 
the PT computers. The following is 
his very informative reply. ED. 



Dear Jim: 

I've reviewed Mr. Hughes letter. 
He is correct with respect to mixing 
drives and controllers. But this is 
not a PT problem; rather it's a prob- 
lem on all computers. On the various 
forums and BBSs, people ask how they 
can use their new drive (usually 
already purchased) with such-and-such 
system. All too often, the mix won't 
work. 

Experienced OSK software companies 
will ask the customer what disk for- 
mat the customer prefers. 

Attempts to mix a 1772 controller 
chip with HD (high-density) 5 1/4" 
dzives is an invitation to disaster. 
They are not compatible. The 1772 
controller chip has a data transfer 
rate of 2S0KBits/sec . A HD 5 1/4" 
drive will transfer data at 300K 
Bits/sec because it is rotating at 
360 rpm unless it is instructed to 
change to 300 rpm. (Don't miss Men 
Gordon's article in this issue. ED ) 
Not all HD 5 1/4" drives are able to 
change speed although I think most 
may be modified to do so. The 1772 is 
unable to support this kind of switc- 
hing. Peripheral Technology has 
solved the HD 5 1/4" speed problem by 
specifying a 300Kbit/sec transfer 
rate but this works only with the 
37C65 controller chip. This solution 
avoids changing the drive speed. 

HD 3 1/2" drives detect the type 
of disk and adjust their speed ac- 
cordingly so they might work with a 
1772. The 37C65 controller chip is 
capable of handling different trans- 
fer rates accounting for the success 
Mr. Hughes achieved with this combi- 
nation. 

Through and including version 2.3 
of OS9/68000, Peripheral Technology 
used standard Microware format. This 
format is 10 sectors per track, track 
0, side 0 and 16 sectors per track 
for the remaining tracks (including 
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track o side l). With version 2.4, 
Microware changed their standard 
format to 'universal' format. Periph- 
eral Technology has followed suit and 
is using the 'universal* format as 
their standard format for 7 20K 
drives. One other common format in 
use is the MIZAR format. This format 
is 16 sectors for all tracks and is 
popular in industry and business^ 

The SYSTEM IV, manufactured by 
Peripheral Technology for DELMAR CO, 
uses 28 sectors per track with a 5 
1/4" drive and 34 sectors per track 
with a 3 1/2" drive. HD drives are 
standard. Should a customer not want 
HD drives, we do provide 720K drives 
and follow the Microware standard 
with the universal format for the 
distributions disks. Alternate for- 
mats are available upon request. The 
HD configuration was selected because 
Western Digital has discontinued the 
1772 controller chip, 720K drives are 
becoming difficult to obtain and the 
rest of the computer industry has 
shifted to HD 3 1/2" drives and HD S 
1/4" drives. We provide descriptors 
to handle the various 720K formats 
for backward compatibility. As long 
as they are available, the 1772 con- 
troller chip can ' be provided as an 
option. 

The CoCo format (18 sectors per 
track) is not a Microware format nor 
do they recognize it. (See the 
'rbfdesc.a* file in the 10 directory 
or the 'systype.d' file in the DBFS 
directory.) This format was devised 
by Tandy to conform with their RSDOS 
format. While Microware did write the 
original 0S9 6809 operating system, 
Tandy's license permitted them to 
make changes and additions which they 
did. All support was the responsibil- 
ity of Tandy. 

Mr. Hughes stated he ordered soft- 
ware "... that was advertised for the 
CoCo, but was OS9, ...'. CoCo OS9 
software is not compatible with OS9/- 
68000. The instruction set used in 
the respective processors is entirely 
different. There is one exception, 
CoCo Basic09 programs will usually 
run under OS9/68000 Basic with slight 
or no modifications so long as graph- 
ics are not required. 

I suggest Mr . Hughes upgrade to 
version 2.4 of OS9/68O00 if he hasn't 
done so already. A complete set of 
descriptors for HD and 80 track DD 
disks for universal, the old Micro- 
ware standard, MIZAR and Tandy Color 
Computer are provided for 3 1/2" and 
5 1/4" HD drives. The upgrade is 
available from PT or we can provide 
it. Starting with version 2.3, Micro- 
ware included a neat utility 'moded'. 
This utility allows editing the desc- 
riptor object code in the CMDS/BOOTO- 
BJS directory without having to as- 
semble them each and every time. 

There are two caveats Mr. Hughes 



should be aware of. If DD, 720K disks 
are to be exchanged between a HD and 
a DD drive, format the disks on the 
DD drive. Formatting on the HD drive 
may yield disks that are unreadable 
by a DD drive. This is not an 0S9/- 
68000 problem; rather it is a hard- 
ware problem having to do with the 
magnetic coating on the disks and the 
head drive currents. And, do not use 
HD disks in a DD drive - the results 
are unpredictable. 

I hope I've responded satisfacto- 
rily. If not, give me a yell! 

Best regards, 

Edward Gresick, Pres. 
DELMAR CO 
PO Box 78 

Middletown Shopping Center 
Middletown, DE 19709 
Phone 302/378 -2555 
FAX 302/378-2556 

Keep tuned, if all goes veil next 
month we'll have a complete answer to 
Bill's first sentence. ED. 
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COGENT ENGINEERING 

PRESENTS THE 
EMBEDDED SOLUTION 

MICRO-CHASSIS 

The Micro-Chassis system consists of a 
single motherboard with multiple add on 
expansion modules. At the heart of the 
Micro-Chassis is a high-speed, 
low-overhead, 32-bit syncronous bus. 
Maximum performance and space efficiency 
is achieved via multilayer, surface mount 
technology. 

68030 Micro-Chassis Motherboard 

25MHz 68030 25Mhz 68882 
2/4/8 Mbytes DRAM Parallel Port 
Dual RS-232 Serial Ports 
6 32-bit MicroChassis Modules 



Expansion modules 

Ethernet 
RS-232/422 
Bytewide Memory 
Universal Prototype 

Operating Systems 

OS/9 SK-DOS 



SCSI/Floppy 
Motor Contra 
DRAM 
A/D.D/A 



UNIFLEX 



Cogent Engineering will also provide 
efficient, low-cost custom design and 
programming services for it's 
Micro-Chassis product line. Call for 
further Information. . 

COGENT ENGINEERING 
45 LAKESIDE AVE, 120 
MARLBORO, MA 01752 
. (508)624-6447 



The Tech Corner 



by J. Scott Kastner 



When we left off laat time, we 
were developing a mini graphics li- 
brary to help ua explore the tech- 
niques and problems involved with 
modern computer graphics. The example 
code for the library was developed on 
a Peripheral Technology OSK system 
with Super VGA. I can't stress highly 
enough to substitute in the code for 
YOUR system if you have something 
different. The resolution that we 
will be working with moat often is 
the VGA 640 X 480 mode in 16 colors, 
just pick a reasonably high resolu- 
tion if yours does not support that 
mode . 

The method for calling the Periph- 
eral Technology graphics driver is 
through the I$SetStt system call; the 
parameters are all held in CPU regis- 
ters. Here is a brief description of 
the two we are using: 



All calls. 

dO.w - path number 
dl.w - function code 

SS^SetMode - Set display mode. 
d2.b - mode value 

SS_WritePix - Set a pixel. 
d2.b • color 
d3.w - x position 
d4 .w - y position 



Laat time, we coded the Graphics 0 
routine in assembly using the #asm 
Vendasm options of the Microware C 
compiler . The routine to set a pixel 
is a little more complicated; we will 
use a mix of C and assembly. Add this 
routine to the 'gfx.c' file started 
last time: 



Listing #2a for gfx.c 



Routine to clip and plot a pixel. 
' " --*/ 

int Plot(x,y,c) register int x,y,c; ( 
/•Return FALSE if off screen.*/ 
if ( (x<0) (y<0) (x>639) 
(y>479) ) return 0; 

t) 

/•Plot and TRUE if on screen.*/ tasm . 
• Save registers for later; 
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movent. 1 do-d4,-(sp) • Sec path and 
function call. 

moveq. 1 #1, do stdOut 

move.w #$85, dl SS_WritePlx * 
Copy aigs to ptopei legs. 

move.b d6,d2 copy coloi 

move.w d4,d3 copy x poa 

move.w ds,d4 copy y poa • Make 
ays call. 

OSS I$SetStt ♦ Recall legB. 

movem.l (sp)*,d0-d4 (tendaam 

return 1; } 



This zoutine demonstrates the ubb 
of register variables. When we enter 
the PlotO routine, the three argu- 
ments are contained in do, dl, and 
one on the stack as described last 
time and in section 3-1 of the Micro- 
waie C compiler manual. The 'regis- 
ter' prefix caused the compiler to 
generate code copying the parameters 
into registers d4, d5, and d6 . The 
values will be accessed from there 
instead of on the stack or something, 
like the compiler would normally code 
it. This is handy for us since we 
need to use them directly with the 
inline code. The inline code copies 
the values to the appropriate regis- 
ters and makes the sys call to the 
driver. On return from PlotO, there 
will be a value in register do. This 
value will be a 0 (FALSE) or 1 (TRUE) 
to indicate whetheT a point was actu- 
ally plotted or not due to the edge 
of screen clipping (the if statem- 
ent) . We could have done this as in 
listing #2b, but it is easier and 
sometimes clearer to use the C code 
when one can. 



Listing »2b for gfx.c 



Routine to clip and plot a pixel. 
•/ 

#aam Plots • Is off in X? 
cmpi.w (to, do x<0 ? 
bge.s Plotl 

clr.l do rtrn FALSE 

rts Plot 1 

cmpi.w #639, do x>639 ? 
ble.s Plot_2 

clr.l do rtrn FALSE 

rts * Is off in Y? Plot_2 
cmpi.w #o,dl y<0 ? 
bge . s Plot_3 

clr.l dO rtrn FALSE 

rts Plot 3 

cmpi.w ¥479, dO y>479 ? 
ble.s Plot_4 

clr.l dO rtrn FALSE 

rts * Save registers for later. 
Plot_4 

movem.l d0-d4,-(sp) * Copy args to 
proper zega. 

move.b 27(ap),d2 copy color 
move.w d0,d3 copy x pos 



move.w dl,d4 copy y pos * Set 

path and function call. 

moveq # 1 , dO S tdOut 

move.w #$85, dl SS_WxitePix * 
Make sys call. 

OS9 I$SetStt * Recall zegs. 

movem.l (sp)+,d0-d4 * Return TRUE. 

moveq #l,dO 

rts #endasm 



The assembly version is a func- 
tional equivalent to #2a. Since it 
was all assembly, extra code was 
needed to get the arguments that were 
passed, and to generate a return 
value. The color value was on the 
stack so we had to fetch it with the 
move.b 27(sp),d2 instruction. How did 
I get the value 27 as the offset for 
this? Well, we pushed do through d4 
on the stack ouz selves. The CPU put a 
return address on the stack from the 
BSR or JSR instruction that called 
this zoutine. This is a total of 6 
long word values, 6*4 - 24. The color 
value is the fizst argument on the 
stack after this, but it was convert- 
ed to a long before being placed on 
the stack, the byte we want is three 
away from the start, so we now have 
6*4 +3-27. Now it should be clear 
why #2a is a little more clear and 
certainly less work. 

The last routine to be added is 
the one to return us to the text 
mode. Just add listing #3 to your 
'gfx.c' file. 



Listing #3 for gfx.c 



Routine to return to text mode. 



#define Text_Mode_80 0x03 

Text!) { 

Graphics (Tex t_Mode 80); ) 



This zoutine just makes a call to 
the gzaphics mode routine we created 
last time. The 'Text_Mode_80' is Just 
a mode value for the 80 column text 
sczeen. The 0x03 is a way of writing 
hexedecimal notation in C. 

At this point, we have covered 
quite a bit of material, so I'll 
break here and let you digest it some 
more. As far as chaptez 3 of the 
Microware C manual, READ IT, LIVE IT, 
LEARN IT, it's your key to really 
getting the most out of a superlative 
C compiler. Next time we will create 
the header file for the library, 
compile it, and do a test drive. 
Until then, I'll leave you with a 
mystery. Why are the two empty braces 
I) in listing #2a necessary for the 
code to work right? I'll give the 
answer next month. 
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Beginner's Corner 



by Ron Anderson 



Last time (Apr '91) we got as far 
as a filter program under SK*DOS, and 
did quite a few variations on a 
theme. Let's talk a little this time 
about simple utility programs. For 
example, suppose you have an Epson 
printer attached to your system and 
want to set it to the "Emphasized- 
mode. The Epson manual indicates you 
have to send it an "escape sequence" 
consisting of the ESCape character 
followed by a capital "E". The 
following program will do that just 
fine: 

* PROGRAM TO SET EPSON TO EMPHASIZED 
MODE 
* 

PUTCH EQU SA033 

VPOINT EQU SAOOO 

WARMST EQU $A01E 

DEVOUT EQU 3275 
* 

START DC VPOINT SET A6 TO POINT AT 
SK'DOS VARIABLES 

MOVE.B »2,DEVOUT(A6) SELECT DEVICE 
2 FOR OUTPUT 

MOVE.B #$1B,D4 $1B IS THE CODE FOR 
THE ESCAPE CHARACTER 

DC PUTCH OUTPUT IT 

MOVE.B #$45, D4 $45 IS THE CODE FOR 

E 

DC PUTCH 

MOVE.B #0,DEVOUT(A6) SET OUTPUT 
DEVICE BACK TO TERMINAL 

DC WARMST RETURN TO SK*DOS 
END START 

The only possible point of 
confusion here is the DEVOUT memory 
location. If you have a printer, your 
STARTUP . BAT file probably has a call 
to the DEVICE utility of SK*DOS. You 
have probably Installed a printer 
driver as device 2. If your printer 
is installed as a device other than 
2, the line below START in the above 
program must be changed so you move 
the correct device number into the 
DEVOUT location. DEVOUT is a variable 
which is part of SK'DOS. It contains 
the number of the device used by 
PUTCH to output a character. 

SK»DOS also has a variable named 
DEVIN which serves the same function 
for input. Assuming you have a modem 
installed on a serial port as device 
4, you could put a 4 in DEVIN (MOVE.B 
#4, DEVIN (A6) ) and receive input from 
the modem just as though it were your 
terminal. 

Of course you would have had to 
define DEVIN with an EQU statement as 
we did for DEVOUT at the beginning of 



. this program. To do something like 
this in a higher level language would 
take quite a few more bytes of code 
and would probably involve a little 
assembler code as well. Anyway, since 
the location of DEVOUT is relative to 
the start of the SK*DOS variables; 
which should be determined by a call 
to VPOINT. 

It is generally easier to 
"massage" the operating system 
directly in assembler code. There are 
all sorts of simple utility programs 
you can write for yourself. For 
example, when you go away from your 
terminal for some time, it is easier 
on the screen if it is blank or 
almost so. I wrote a quick program 
called CL to handle that for me. On 
one of the 68000 systems I use, we 
have a serial terminal. It is an 
"ANSI" standard terminal which 
emmulates a VT-100. The code sequence 
to clear the screen and put the 
cursor on the first line is rather 
complex but it will serve to 
illustrate how easy it is to do. 

* PROGRAM TO CLEAR SCREEN AND HOME 
CURSOR ANSI TERMINAL 
* 

PUTCH EQU $A033 
WARMST EQU $A01E 

ORG $0000 
START MOVE.B #$1B,D4 

DC PUTCH 

MOVE.B #' {' ,D4 

DC PUTCH 

MOVE.B #'2' ,D4 

DC PUTCH 

MOVE.B #' J' ,D4 

DC PUTCH 

MOVE.B #$1B,D4 

DC PUTCH 

MOVE.B »• (• ,D4 

DC PUTCH 

MOVE.B #'1' ,D4 

DC PUTCH 

MOVE.B #';'.D4 

DC PUTCH 

MOVE.B ,D4 

DC PUTCH 

MOVE.B tt'H',D4 

DC PUTCH 

DC WARMST 

END START 

A simpler program clears the 
screen of most terminals such as the 
Televideo or Wyse non ANSI versions. 

• PROGRAM TO CLEAR SCREEN AND HOME 
CURSOR 
* 

PUTCH EQU $A033 
WARMST EQU $A01E 

ORG $0000 
START MOVE.B #$1B,D4 

DC PUTCH 

MOVE.B #'*',D4 

DC PUTCH 

DC WARMST 

END START 
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You night look at these programs, 
particularly the fiist, and say we've 
done it very inefficiently. We could 
define a string of bytes terminated 
with a 4 and call the SK*DOS system 
routine PNSTRN, which outputs a 
string without a leading CRLF. Just 
fox fun, let' s do it that way and get 
a feel for how much we could save in 
program code and bytes, 

* PROGRAM TO CLEAR SCREEN AND HOME 
CURSOR ANSI TERMINAL 

* 

PUTCH EQU SAO 3 3 
PNSTRN EQU $A036 
WARMST EQU SAO IE 

ORG $0000 
START LEA STRING (PC) , A4 

DC PNSTRN 

DC WARMST 
STRING FCC $lB,»[2J»,$lb,"(l;lH",4 

END START 
-P 

At this level of program, it 
really doesn't matter much. The whole 
program is leas than one sector of 
disk storage, and a whole sector 
would be UBed for any program from 1 
to about 245 bytes. When you run this 
CL program you won't be doing 
anything else, so memory usage is not 
important either. 

As a matter of interest the first 
"long way" program is 62 bytes and 
the one directly above, which works 



identically is 19 bytes. I should 
mention I have been using the long 
one for a year or more, primarily 
because it was a simple extension of 
the non-ascii clear program that had 
been done first. Looking at it again 
today brought to mind there was a 
better way. 

I find with programming there 
seems to be no end of looking at a 
program and making it better and 
shorter or faster . The improvements 
come more slowly and make less change 
in the performance or size of the 
program after you have worked on it 
for a long time, but you never reach 
the point where improvements cannot 
still be made. (Well, of course, for 
a very simple two line program, you 
do reach that point, but for any 
non- trivial program, it seems to be a 
never ending process) . 

Now looking at the program' s 
content, obviously for the non-Ascil 
terminal, ESC * is the sequence which 
clears the screen and homes the 
cursor. The ANSI version requires: 
ESC [2 J to clear the screen and ESC 
[1;1H to put the cursor at row 1 and 
column 1 of the screen. The Hercules 
board video version for the PT68K-2, 
which probably most of you have, uses 
the code $1A (control Z) . You only 
need to send it one character, as 
below: 

* PROGRAM TO CLEAR SCREEN AND HOME 



PT68K2/4 Programs for REXDOS & SK*DOS 



EDDI 


A screen editor and formatter 


$50.00 


SPELLB 


A 160,000-word spelling checker 


$50.00 


ASMK 


A native code assembler 


$25.00 


SUBCAT 


A sub-directory manager' 


$25.00 


KRACKER 


A disassembler program 


$25.00 


NAMES 


A name and address manager 


$25.00 



Include operating system, disk format, terminal type and telephone 
number with order. Personal checks accepted. No charge cards. 



PALM BEACH SOFTWARE 
Route 1 Boxll9H 
Oxford, FL 32684 
904/748-5074 
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CURSOR 

* F° R PT68K-2 USING MONOGRAPHICS 
BOARD 
* 

PUTCH EQU $A033 WARMST EQU $A01E 
ORG $0000 START MOVE.B #$1A,D4 
DC PUTCH 
DC WARMST 
END START 

Well, there you aee some of the 
usefulness of Assembler programming, 
particularly with regard to massaging 
the operating system to make it do 
what you want it to do. We've looked 
at filter programs, found out how to 
open and close disk files, and talked 
to the printer and terminal with 
simple utility programs. Next time 
we'll look at higher level languages 
and see why we might not find them 
appropriate for all of our programs. 



The Eccentric 
Programmer 



by Randy Krippner 



A famous computer scientist once said 
the comment that using BASIC causes brain 
damage. I find that comment abeuic. I am 
a BASIC programmer and I can assure you 
that my brain isn't damaged in the sligh- 
test. (The rumor that I entered a Madonna 
look-alike contest and took second place 
is a vicious rumor. I took first.) Just 
because someone chooses to program in 
BASIC doesn't mean that his or her RAM 
bank is a few chips short of a full meg. 

One thing that can make an otherwise 
normal person feel a sudden urge to go 
live with the squirrels is trying to 
learn a new programming language, once 
you have become thoroughly familiar a 
language, it can be difficult to adapt to 
a new one. This is true even when chang- 
ing from one version of a language to 
another. In fact, moving from one dialect 
of a language to another can sometimes be 
more difficult than trying to learn an 
entirely different language. This is 
especially true when trying to move from 
a 'standard' BASIC like Extended Color 
BASIC to a modern version like Basic09. 

If you've decided to take the plunge 
and switch from ECB to Basic09, you're in 
for a surprise. BASIC ain't BASIC any 
more, folks. Take a look at the two sim- 
ple code fragments below: 

10 REM JUNKLOOP . BAS 
20 FOR CT - 1 TO 10 
30 PRINT "Hello" 
40 NEXT CT 
SO END 

PROCEDURE JunkLoop 
DIM Count I INTEGER 
FOR count " 1 TO 10 

PRINT "Hello" 
NEXT count 
END 

These two programs, the first in ECB, 
the second in Basic09, do exactly the 
same thing, but there are some signifi- 
cant differences in how they do it. 

The most obvious difference is that 
the Basic09 program doesn't have line 
numbers. Line numbers are optional in 
Baeic09. They are required only when a 
line is referenced by a goto or GOSUB. 
Otherwise they can be used or not, de- 
pending on the programmer's preference 

The PROCEDURE line of the Basic09 
listing is also something new. Every 
Basic09 program starts with the word 
PROCEDURE, followed by the name of the 
program or module. 

The PROCEDURE line is inserted auto- 
matically by the Basic09 editor whenever 
you start to write a new program. To 
start editing a new program, you would 
type i 

e JunkLoop (ENTER) 
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The "e" tells Baeic09 to go into the 
edit node. The word after the "e" is the 
name of the nodule you want to edit. If 
the nodule does not exist, Basic09 will 
cieate it, giving it "the name you typed. 
If a nodule of that name already exists, 
Basic09's editor will allow you to edit 
that module. If you do not enter a name 
after the "e" command, Basic09 will give 
the procedure a name of "program". 

If ECB is the only language you've 
ever used, you may find the DIM statement 
in the second line. In ECB, DIM is used 
only to dimension an array, as in DIM 
Ado). In Basic09, however, DIM serves 
two purposes. It is used to dimension 
arrays, just as in ECB, but it is also 
used to declare variable types. 

In ECB, there are only two types of 
variables; numeric and string. Basic09 
has fire different variable types; inte- 
ger, real, byte, string, and boolean. 

In Baaic09, real variables and Bering 
variables are similar to ECB' a numeric 
and string variable types. Seal variables 
are used to hold standard floating point 
numbers. String type variables hold, of 
course, strings. However, string vari- 
ables under Baeic09 are a bit different 
from what you may be used to. 

Integer variables are numeric vari- 
ables also, but they can only hold whole 
numbers in the range of -32768 to *32767. 
Byte variables are also numeric, but the 
values they can hold are limited to the 
range of 0 - 255. 

Boolean variables are used exclusive- 
ly for logical comparisons. They can hold 
only one of two values, TODS or FALSI. 
Boolean variables are usually used as 
flags to test to see if specific condi- 
tions have been met. 

And as if that isn't enough, BasicQ9 
also supports user defined data types, 
something we'll get into a bit later. 

Why all of these different variable 
types? It may seem that all of these 
different types would confuse things, but 
they actually help programmers in the 
long run. 

These different data types can make a 
program much more efficient in terms of 
execution speed and memory use. Look at 
JunkLoop- again. I've declared count to be 
an integer variable. Since it is an inte- 
ger, it takes up only two bytes of memo- 
ry, rather than the five bytes a zeal 
variable would have taken up. 

Also, since it is an integer rather 
Chan a floating point value, mathematical 
operations are performed much more quick- 
ly. Performing manipulations on floating 
point numbers takes a great deal of time. 

(Note: You have to make sure that the 
lumber being stored in the variable will 
lot exceed the capacity of the variable's 
cype. ) 

What happens if you do not declare a 
/ariable with a DIM statement before you 
lae it? Well, unlike Pascal and C which 
require all variables to be declared 
seforo they can be used, Basic09 will 
lllow you to create new variables on the 
fly, so to speak. Undeclared numeric 
variables default to the real type. Unde- 
:lared string variables default to a 
)tring length of 32 characters. (Unlike 
-CB which automatically adjusts the 
length of a string to match the string 
lssigned to it, under Basic09 you have to 



set' the maximum string length yourself. 
It may sound like an annoyance, but there 
are advantages. First, strings are not 
limited to 255 characters in length. A 
Basic09 string can be as long as you like 
(within memory limitations) . The second 
advantage is that there is no need to 
endure the dreaded "garbage collection" 
delays for which ECB is so justifiably 
infamous. Because Basic09 strings are of 
a fixed length set by the programmer, the 
language doesn't have to pause to reorga- 
nize string memory.) 

Another advantage of Basic09 is that 
you are no longer restricted to two char- 
acter variable names. Variable names can 
be up to 32 characters long, all of them 
significant. You don't have to go crazy 
trying to figure out whether CT$ is the 
customer name, credit rating or something 
else. Under Basic09 you can give vari- 
ables names that actually mean something 
useful, such as CustName or CreditRating. 

Now let's talk about those four digit 
numbers that appear in front of every 
line in a Basic09 program. If you type in 
JunkLoop and then list it, you'll see 
something like this i 

PROCEDURE JunkLoop 
0000 DIM count I INTEGER 
0007 FOR count-l TO 10 
0017 PRINT "Hello" 

0033 NEXT count 
003E END 

Newcomers to Basic09 often think 
these are line numbers. They aren't. They 
are actually hexadecimal addresses. The 

number to the left of the line is the 
address of where that line of code starts 
in the computer's memory. (This is is not 
the actual memory location where the 
program is stored. Normally we don't 
know, and don't care, exactly where a 
program is stored in memory. OS9 and 
Basic09 take care of that for us. The ad- 
dresses displayed in a Basic09 program 
are offsets from the beginning of the RAM 
area being used. For example, perhaps OS9 
has given Basic09 a block of RAM starting 
at 0100 hex. The offset is added to the 
base address to produce the true address 
of where that particular item is stored. 
So the second line of JunkLoop is not 
really stored at 0007, but at 0107, or 
the base address plus the offset.) 

Since exactly where a Basic09 program 
is located in memory is normally some- 
thing we don't care about, why does Basi- 
c09 give us this list of addresses? 

Well, the addresses can help you when 
you are debugging a program. Remember, we 
aren't working with line numbers, so it 
can sometimes be difficult to find a 
particular location in a program. If your 
program crashes, Basic09's built in debu- 
gger will give you an error message that 
includes an address, telling you where 
the problem turned up. You can compare 
that address with the list of addresses 
printed in the Basic09 listing to find 
where the error took place. 

Next time we'll continue our move 
from ECB to Basic09 . Questions can be 
sent to Randy Krippner, 1014 W. Hwy. 114, 
Lot 29. Hilbert, WI 54129. Please include 
an sase. 
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